Resource URL: /platform/<<version=3>>/fsa/results/<ID>/top-files/<STAT>

    Overview: Retrieve the top files according to the STAT parameter.

     Methods: GET

********************************************************************************

Method GET: This resource retrieves the top files. ID in the resource path is
            the result set ID.

       URL: GET /platform/<<version=3>>/fsa/results/<ID>/top-files/<STAT>

Query arguments:
        sort=<string> The field that will be used for sorting.
      start=<integer> Starting index for results. Default value of 0.
      limit=<integer> Number of results from start index. Default value of 1000.
comp_report=<integer> Result set identifier for comparison of database results.
           dir=<enum> Where <enum> is one of ASC, DESC.  The direction of the
                      sort.

GET response body schema:
{
  "type": [
    {
      "additionalProperties": false, 
      "type": "object", 
      "description": "A list of errors that may be returned.", 
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false, 
            "type": "object", 
            "description": "An object describing a single error.", 
            "properties": {
              "field": {
                "type": "string", 
                "description": "The field with the error if applicable."
              }, 
              "message": {
                "type": "string", 
                "description": "The error message."
              }, 
              "code": {
                "type": "string", 
                "description": "The error code."
              }
            }
          }, 
          "type": "array"
        }
      }
    }, 
    {
      "type": "object", 
      "properties": {
        "files": {
          "items": {
            "type": "object", 
            "properties": {
              "log_size": {
                "required": true, 
                "type": "integer", 
                "description": "Logical file size in bytes."
              }, 
              "ctime": {
                "required": true, 
                "type": "integer", 
                "description": "Unix inode change time."
              }, 
              "btime": {
                "required": true, 
                "type": "integer", 
                "description": "File creation begin time."
              }, 
              "phys_size": {
                "required": true, 
                "type": "integer", 
                "description": "Physical file size in bytes."
              }, 
              "path": {
                "required": true, 
                "type": "string", 
                "description": "Relative file path under /ifs/."
              }, 
              "atime": {
                "required": true, 
                "type": "integer", 
                "description": "File access time."
              }
            }
          }, 
          "required": true, 
          "type": "array", 
          "description": "Files listing."
        }, 
        "atime_enabled": {
          "required": true, 
          "type": "boolean", 
          "description": "Access time enabled."
        }, 
        "dir_atime_enabled": {
          "required": true, 
          "type": "boolean", 
          "description": "Directory access time enabled."
        }, 
        "top_n_max": {
          "required": true, 
          "type": "integer", 
          "description": "Limit on number of top results."
        }, 
        "total_count": {
          "required": true, 
          "type": "integer", 
          "description": "Total count of file results."
        }, 
        "change": {
          "required": false, 
          "type": "integer", 
          "description": "Change in file ranking from result set comparison."
        }
      }
    }
  ]
}
